package com.rdk.wechat.request;

/**
 * 用户管理请求服务接口
 * 包含4个基础服务请求：
 * 1.获取UserToken
 * 2.获取用户基本信息
 * 3.获取好友列表分页时间戳
 * 4.获取用户好友关注列表
 * 
 * @author wanglei
 *
 */
public interface UserWechatRquest {
	
	/**
	 * 获取用户登录的唯一票据
	 * userToken只能使用一次，并且有效期为3分钟
	 * 
	 * @param clientKey 接入的key值，从豆豆中或者是登录系统获取的登录票据
	 * 
	 * @return json String
	 */
	String getUserToken(String clientKey);
	
	/**
	 * 获取用户基本信息
	 * 通过该接口获取用户基本信息，包括用户ID、昵称、头像、
	 * 性别、所在城市、语言等；非企业用户，不能获取。 
	 * 
	 * @param userToken 用户接入凭证
	 * @param lang 返回国家地区语言版本zh_CN 简体、zh_TW 繁体、en 英语 
	 *  
	 * @return json String
	 */
	String  getUserInfo(String userToken, String lang);
	
	
	/**
	 * 获取好友列表分页时间戳
	 * 通过该接口获取用户的好友分页时间戳判断好友分页信息，
	 * 根绝页码信息获取好友列表
	 * 
	  * @param userToken 用户接入凭证
	 * @param lang 返回国家地区语言版本zh_CN 简体、zh_TW 繁体、en 英语 
	 *  
	 * 
	 * @return json String
	 */
	String getUserBuddysTimestamp(String userToken, String lang);
	
	/**
	 * 获取用户好友关注列表
	 * 
	 * @param accessToken 接入凭证
	 * @param userToken 用户接入凭证
	 * @param lang 返回国家地区语言版本zh_CN 简体、zh_TW 繁体、en 英语 
	 * @param pageNo 页码
	 * 
	 * @return json String
	 */
	String getUserBuddysToPaging(String userToken,String lang, String pageNo);

}
